IUEqualString

Test equality of two international p- strings

short IUEqualString(strA, strB );

Str255 strA ; strings to ...

Str255 strB ; ... compare

returns 0 if equal, 1 if not equal

IUEqualString compares two pascal-style strings and indicates whether or

not they are equal. The comparison is insensitive to character case and it

ignores diacritical marks. Note that the return value is NOT a Boolean.

strA and . . .

strB are the addresses of pascal-style length-prefixed strings to be

compared.

Returns: a signed integer; it identifies whether or not strA and strB are equal.

The value is the reverse of a normal Boolean; one of:

0 strA and strB are equal as defined below.

1 strA is NOT equal to strB.

Notes: The return value is contrary to C usage of booleans.

IUEqualString ignores character case and diacritical marks. For

instance,

"Alfred

"alfred

"Ålfred

are all considered to be equal.

If one string is shorter than the other, the function immediately returns a

1 (i.e., not equal).

To test equality of unformatted text (i.e., non-pascal strings), use

IUMagIDString. For sorting use IUCompString which tells you which

string is greater. For a faster raw ASCII equality test, use EqualString.

Referenced by (19):